Collection::Empty

Section: ET++ method description (n)
Updated: automatically Fri Mar 1 10:57:30 1991
Index Return to Main Contents

NAME

Collection::Empty - instance method

TEMPLATE

void Empty(int initialCapacity)

SPECIFIERS

public virtual

DESCRIPTION

Empties the receiver, e.g. its size becomes zero. Note that the elements are not deleted. Empty sends a change message.
The argument initialCapacity is a hint indicating an expected number of elements. Overridden Empty methods may take it into account to improve performance. A negative initialCapacity is an error (level Warning).
Empty sends the default change message if the size had been greater than 0.
See also method FreeAll and method RemoveAll. Method is often overridden.

ARGUMENTS

int initialCapacity: Greater or equal 0. initialCapacity is conceptually unsigned but is declared as int for convenience.

RETURN ARGUMENT

void

FIRST DEFINITION

class Collection

FILES

implementation:: Collection.C

KNOWN PROBLEMS

A default argument of 0 should be declared for initialCapacity.
Not all current implementations of Empty consider a negative initialCapacity as error.
Currently, no implementation of Empty sends a change message.

This document was created by man2html, using the manual pages.
Time: 00:40:31 GMT, March 30, 2022